home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / vgapal10.arc / VGAPAL.DOC < prev    next >
Text File  |  1991-08-18  |  9KB  |  198 lines
  1.              VGAPAL.DOC  Documentation For VgaPal v1.00 (ShareWare)
  2.  
  3.       VGAPAL in both source and executable forms and its documentation is
  4.            Copyright (c) 1991 Aureal Systems Ltd. All Rights Reserved
  5.  
  6.                  Program and Documentation by Michael Ralphson
  7.  
  8.                        Last Modified on 11th August 1991
  9.  
  10. Disclaimer
  11. ──────────
  12.  
  13. Aureal Systems Ltd disclaim all warranties, including (but not limited to)
  14. fitness for stated purpose and being of merchantable quality until such time as
  15. the user registers. At no time will Aureal Systems Ltd be held responsible for
  16. the consequences of the use, misuse or abuse of this software or documentation.
  17.  
  18.  
  19. What Is VgaPal?
  20. ───────────────
  21.  
  22. VgaPal is a text mode colour palette changing program for the VGA graphics
  23. adapter. It allows you to access the full range of VGA colours (all 262,144 of
  24. them) and assign them to the 16 standard text colours.
  25.  
  26. System Requirements
  27. ───────────────────
  28.  
  29. VgaPal requires a true IBM compatible PC/XT or AT with a VGA, Super VGA or XGA
  30. display.
  31.  
  32. VgaPal will still be useful with a monochrome VGA screen for programs that pick
  33. colours that are hard to see on your system.
  34.  
  35. VgaPal will not function on old tin boxes, no matter what graphics adapter /
  36. monitor they are fitted with. If you are in possession of such equipment,
  37. please hand it in to your local police station.
  38.  
  39. Program Usage
  40. ─────────────
  41.  
  42. VgaPal has two modes of operation. In command-line mode you may give it one of
  43. the following parameters:
  44.  
  45. VGAPAL GREY             Grey Scales the current palette
  46. VGAPAL GREY!            Grey Scale palette with no blinking
  47. VGAPAL DEFAULT          IBM Hardware default palette
  48. VGAPAL DEFAULT!         IBM Hardware defaults with no blinking
  49. VGAPAL <filename>       Load the pre-saved palette called <filename>
  50.  
  51. If you select a 'no-blinking' mode, you will notice that you now have the full
  52. complement of 16 foreground AND 16 background colours, instead of the usual 16
  53. foreground, 8 background plus blinking.
  54.  
  55. VgaPal will ignore an exclamation mark (!) after a file name, as the status of
  56. the blinking toggle is stored within the palette file.
  57.  
  58. In Interactive Mode, VgaPal allows you to design your own palettes and see the
  59. effects on screen immediately.
  60.  
  61. Interactive Mode
  62. ────────────────
  63.  
  64. In Interactive Mode the screen will look something like this (you'll have to
  65. imagine the colours!):
  66.  
  67.  VGA Palette Changer - ShareWare Version Copyright (c) 1991 Aureal Systems Ltd
  68.                                                                               
  69.  0  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Black (DOS background)   ■■■■■■■■■■■■■■■■      
  70.  1  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Blue                     ■■■■■■■■■■■■■■■■      
  71.  2  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Green                    ■■■■■■■■■■■■■■■■      
  72.  3  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Cyan                     ■■■■■■■■■■■■■■■■      
  73.  4  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Red                      ■■■■■■■■■■■■■■■■      
  74.  5  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Magenta                  ■■■■■■■■■■■■■■■■      
  75.  6  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Brown                    ■■■■■■■■■■■■■■■■      
  76.  7  █████▓▓▓▓▓▒▒▒▒▒░░░░░ <══   White (DOS Foreground)   ■■■■■■■■■■■■■■■■
  77.  8  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Dark Grey                ■■■■■■■■■■■■■■■■      
  78.  9  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Light Blue               ■■■■■■■■■■■■■■■■      
  79. 10  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Light Green              ■■■■■■■■■■■■■■■■      
  80. 11  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Light Cyan               ■■■■■■■■■■■■■■■■      
  81. 12  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Light Red                ■■■■■■■■■■■■■■■■      
  82. 13  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Light Magenta            ■■■■■■■■■■■■■■■■      
  83. 14  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Yellow                   ■■■■■■■■■■■■■■■■      
  84. 15  █████▓▓▓▓▓▒▒▒▒▒░░░░░       Light White              ■■■■■■■■■■■■■■■■      
  85.                                                                               
  86.  R├──────────────────────────────────────────╫─────────────────────┤  67%
  87. >G├─────────────────────────────────────╫──────────────────────────┤  55%
  88.  B├──────────────────────────────────────────╫─────────────────────┤  67%     
  89.                                                                               
  90. ESC, C)larion, I)nitial, D)efault, S)ave, L)oad, G)rey, R)andom, B)link
  91.  
  92. The 16 colours in the top section of the display are the 16 colour 'slots' that
  93. you can change. The 'names' of the colours are there for reference, just to
  94. show how other programs will think of your new colour scheme.
  95.  
  96. You can move the slot selector [<══] with the Up and Down arrow keys and change
  97. the colour component selector [>] from Red, Green and Blue with the space bar.
  98.  
  99. To change the actual colour, move the selected Slider Bar with the Left and
  100. Right arrow keys, Home to move to 0%, End to move to 100%, PgUp to add 10% and
  101. PgDn to decrease by 10%.
  102.  
  103. Pressing I at any time reinstates the palette that was in effect when you
  104. loaded VgaPal.
  105.  
  106. Pressing D restores the IBM Hardware defaults just like the command line
  107. option, but has no effect on the Blinking toggle.
  108.  
  109. Save and Load allow you to keep a library of your own palettes, the default
  110. extension being .PAL
  111.  
  112.                           * REGISTERED VERSION ONLY *
  113.  ┌───────────────────────────────────────────────────────────────────────────┐
  114.  │  However, if you specify the extension .COM for your file, the palette    │
  115.  │  will be saved as a self-loading .COM file that can be run from DOS and   │
  116.  │  given away or sold with your applications without the need for your end  │
  117.  │  users to have a copy of VGAPAL. The palette loader program was written   │
  118.  │  in assembly language to keep it small, and saved palettes take up less   │
  119.  │  than 300 bytes if they are self running. If you want to load a .COM      │
  120.  │  file palette back into VGAPAL for editing, just run it from DOS prior to │
  121.  │  loading VGAPAL. The registered version will also produce .OBJ files      │
  122.  │  suitable for linking into almost any programming language.               │
  123.  └───────────────────────────────────────────────────────────────────────────┘
  124.  
  125. Pressing C saves a short text file that contains the commands necessary to make
  126. the Clarion Professional Developer language extension module (VGALEM, also
  127. available from Aureal Systems) set your chosen palette colours.
  128.  
  129. VgaPal was a spin-off from our work with the Clarion LEMs, written in Turbo
  130. Assembler. VgaPal itself is written in Turbo Pascal v6.0.
  131.  
  132. Pressing G behaves just like the command line option GREY, but has no effect on
  133. the Blinking toggle.
  134.  
  135. Pressing R selects random values for the Red, Green and Blue components of the
  136. selected colour.
  137.  
  138. Pressing B toggles the blink status from 8 backgrounds plus blinking to 16
  139. backgrounds and back again.
  140.  
  141. To Quit, just press ESCape.
  142.  
  143. Excuse Me
  144. ─────────
  145.  
  146. Yes?
  147.  
  148. Wouldn't It Be Good To Be Able To See The Program I'm Changing The Colours For?
  149. ───────────────────────────────────────────────────────────────────────────────
  150.  
  151. I was wondering when you'd get to that. Yes, it would be nice. And all you have
  152. to do to have this capability is to register this piece of software.
  153.  
  154. VGATSR will pop-up over any text-mode application, allowing you to change any
  155. colours, and immediately see the effect your changes will have on menu boxes,
  156. backgrounds, contrasting text colours et cetera.
  157.  
  158. Once you have decided on your colour scheme, you can save a 'standalone' copy
  159. of the palette (.PAL or .COM) with the registered version of VGAPAL and remove
  160. VGATSR from memory completely without having to reboot your computer.
  161.  
  162. How Do I Register VgaPal?
  163. ─────────────────────────
  164.  
  165. Send a cheque or postal order for £15.00 (which includes UK postage and
  166. packing) to the following address. Please phone for details of credit card
  167. registration. Foreign customers should contact us before ordering to discuss
  168. method and cost of delivery.
  169.  
  170.                           Aureal Systems Ltd (VgaPal),
  171.                              1-2 Oakley Hay Lodge,
  172.                                Great Folds Road,
  173.                                Corby, NORTHANTS.
  174.                                     NN18 9AS
  175.  
  176.     Our telephone number is Corby (0536) 744711 / 744474, Fax (0536) 744551.
  177.  
  178.     If you have a modem, we can be reached on the Aureal BBS, (FidoNet Node
  179.           2:254/153 - V21 to V32 - 24 Hours), data only (0858) 466594
  180.  
  181. You will receive the VGATSR program, the latest registered version of VGAPAL
  182. (with any additional changes made since release), example palettes, future
  183. upgrade information and free bulletin board support.
  184.  
  185. What Is Aureal Systems?
  186. ───────────────────────
  187.  
  188. Aureal Systems Ltd is a company primarily concerned with data communications,
  189. hardware solutions (PCs, modems, networks) as well as complete software
  190. systems. We are the primary distributor for Texas Instruments modems in the
  191. United Kingdom.
  192.  
  193. If you have any queries about any of our products, would like to receive our
  194. comprehensive price-list or would like to discuss your requirements please do
  195. not hesitate to contact our technical / sales staff.
  196.  
  197.                                       END
  198.